home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / PC_server / ka9q / gophtrac.txt < prev    next >
Encoding:
Text File  |  1993-04-23  |  4.4 KB  |  137 lines
  1.       GophTrac -- A PC Gopher Server Directory Manager
  2.  
  3.            by Rod Potter, York University, Canada
  4.  
  5. This is a beta version of GophTrac, a simple (I hope) front end 
  6. database application for creating and managing GINFO files for 
  7. the Ka9Q PC Gopher server. If there is interest, this application 
  8. could be easily adapted to work with Gunter Hille's server. 
  9.  
  10. Why?
  11. ----
  12. Well, there is already a nice front end for the Mac Gopher server 
  13. and my programming experience and tools are limited to the PC. I 
  14. don't know if anything exists for other platforms, yet. I know a 
  15. few people who would like to see a Unix front end. 
  16.  
  17. Disclaimer
  18. ----------
  19. This is BETA Software. I've been using it to manage a simple non-
  20. production gopher server and it seems to work fine. You may not 
  21. agree. Since this program reads and writes GINFO files, you are 
  22. strongly advised to backup your hard drive -- or at least 
  23. experiment on a non-production system. I take no responsibility.
  24.  
  25.  
  26. Installation
  27. -------------
  28. 1) Make a directory on your hard drive called "GOPHTRAC"
  29.  
  30. 2) Copy all of the files in this archive to the GOPHTRAC 
  31.    Directory
  32.  
  33.  
  34. Configuration
  35. -------------
  36. GophTrac needs to know where your gopher server resides. 
  37. Typically this will be "C:\GOPHER" or "D:\GOPHER". The program 
  38. also needs to know your local machine name and the default PORT 
  39. you use for your Gopher server (usually 70). 
  40.  
  41. To configure these parameters, run GophTrac and select the 
  42. Maintenance/Configure menu:
  43.  
  44. 1) Run GophTrac by typing "GOPHTRAC" at the DOS command line.
  45.  
  46. 2) Use the PC arrow keys or type "M" to select the Maintenance 
  47.    menu. Then select the Configure menu.
  48.  
  49. 3) Plug in the requested information.
  50.  
  51.  
  52. Using GophTrac
  53. --------------
  54. GophTrac tries to manage your GINFO files in a number of ways:
  55.  
  56. a) When you process a new directory (that has no GINFO file) it 
  57. will create a working database (GOPHTRAC.DBF) which contains that 
  58. directory's file names, default machine names and port numbers. 
  59. GophTrac's Editing and Browsing functions let you correct and 
  60. fill in these details.
  61.  
  62. b) If there is already a GINFO file in the selected directory, 
  63. GophTrac will build the working database (as above) and compare
  64. it with the existing GINFO file. This information will be merged 
  65. into a new database (GINFO.DBF) so you can edit it. 
  66.  
  67. c) If you have ADDED files to a gopher directory, GophTrac will 
  68. create a GINFO entry. If you have removed file(s) from a gopher 
  69. directory, GophTrac will remove the corresponding GINFO entry 
  70. when it builds the working database.
  71.  
  72. d) When a working GINFO.DBF database has been edited, GophTrac 
  73. will prompt you to see if you want to UPDATE that directory's 
  74. GINFO file. The program simply outputs the appropriate fields to 
  75. rebuild the GINFO file.
  76.  
  77.  
  78. Processing Directories
  79. ----------------------
  80. GophTrac lets you work with one directory at a time. Select the 
  81. Directory command and use the up and down arrow keys to select 
  82. a gopher directory. Press Enter so see the files in the 
  83. directory. Press enter again to begin processing. This is what 
  84. the program does.
  85.  
  86. A) EXISTING DIRECTORY (Has a GINFO File)
  87.    - Imports the GINFO file into GINFO.DBF
  88.    - Imports all files names into GOPHTRAC.DBF
  89.    - Compares them
  90.    - Adds/removes file entries from the GINFO database as 
  91.      necessary
  92.    - Let's you browse and edit this database
  93.    - Asks for your blessing to rebuild the GINFO file
  94.  
  95. This version does not understand DIRECTORY items. If there are 
  96. type 1 items in an existing GINFO file, GophTrac will not touch 
  97. them. 
  98.  
  99.  
  100. B) NEW DIRECTORY (No GINFO File)
  101.    - Creates a bare bones GINFO.DBF file based on files on the 
  102.      directory
  103.    - Lets you browse and edit this database
  104.    - Asks for your blessing to build a new GINFO file
  105.  
  106. Again, since the program does not know what a directory is, it 
  107. will ignore them when it creates the new GINFO file. This will be 
  108. fixed soon.
  109.  
  110.  
  111. Futures
  112. -------
  113. As I said, this is Beta. This serves my purposes, but I'd be 
  114. interested in some feedback before going further.
  115.  
  116. a) GophTrac only understands Type 0 objects (files). It does not 
  117. yet capture and create GINFO entries for directories or other 
  118. objects. 
  119.  
  120. b) Order. I need to add an ORDER field, so that items can be 
  121. prioritized.
  122.  
  123. c) A File Manager. It would be nice to be able to use GophTrac to 
  124. Copy/Move/Delete files within the Gopher tree.
  125.  
  126. d) Windows/Windows NT versions. Maybe.
  127.  
  128. That's about it. Suggestions/criticisms would be appreciated:
  129.  
  130. Rod Potter, rodp@orion.yorku.ca
  131. Computing and Communications Services
  132. York University
  133.  
  134.  
  135.  
  136.  
  137.